A: Rule #1: don't panic. Use your brain. Read this doc carefully. If the plug-in seems to work incorrectly, go to http://pp666.cjb.net/midi.htm and get the latest update. If DirectMusic devices cause the problem, update your DirectX drivers - http://www.microsoft.com/directx/
Q: Winamp crashes / freezes when I try to play MIDI.
A: Well, blame your sound card drivers for that. There are a few possible solutions:
(1) disable sampling (output tab)
(2) make sure that Winamp process priority class is set to 'normal' (in Winamp preferences / options), then select 'MIDI mapper / MCI' device - this is (almost) exact clone of the old MIDI plug-in code.
(3) select 'MIDI mapper' device (or any other midiOut device) and try switching between streamed / immediate modes.
(4) try ALL available devices; Microsoft synth is very likely to work (it doesn't use your MIDI hardware).
Note: if (2) doesn't work, then either the MIDI file that causes it is really damaged or your sound card drivers are seriously messed up.
Q: Winamp seems to play MIDI, but I can't hear anything.
A1: Click "reset midiOut volume" in device tab.
A2: Make sure that MIDI isn't muted in Windows' volume control.
A3: Try all available devices, especially MCI and Microsoft synth.
A4: Try various volume control options (device tab).
Q: I have SB16 ...
A: Select Microsoft Synthesizer device (available only if you have DirectX 6.1 or higher installed).
Q: I have a problem with VIS...
A: If you use MS synthesizer, enable 'play through Winamp's ouptut system'; otherwise enable 'sample data for VIS'.
Q: I get no error messages but VIS doesn't work and/or written WAVs contain silence; I use 'sample for VIS' option.
A: Go to output / sampling / source and select where is your MIDI device connected (usually 'MIDI').
Q: How do I convert MIDI to WAV ?
A: There are three ways:
(1) select Microsoft Synthesizer device, enable 'play through Winamp's ouptut system' and use some disk writer output plug-in (Nullsoft Disk Writer or my ACM WAV writer)
or
(2) enable sampling, enable 'use internal WAV writer' option and choose output directory for WAV files.
or
(3) enable sampling, enable 'send sampled data to output' and use the Disk Writer output plug-in
I recommend setting mixing/sampling frequency to 44100 Hz while writing WAV.
If you use sampling, output files contain exactly what you heard while writing; it's a good idea to disable all effects like reverb or chorus in your sound hardware in this case.
Q: I want to convert MIDI to WAV but my sound card doesn't allow me to record MIDI...
A: See (1) above.
Q: What do all the volume control options do ?
A: First option - 'none' - totally disables volume control. Second one - 'driver-specific' - sends volume change commands to MIDI drivers ( midiOutSetVolume(), IDirectMusicPerformance::SetVolume(), channel volume commands in immediate mode with alt. vol. setting enables ). It works with almost all devices, but it is known to do bad things on certain sound cards. Remaining options refer to Windows' mixer lines.
Q: I can't hear MIDI at all; even all other MIDI players I have produce silence since I installed Winamp.
A: Click device tab / reset midiOut volume (takes immediate effect). Make sure that you DO NOT use 'driver-specific' volume setting mode.
Q: What are compressed MIDI files ?
A: A compressed MIDI file is a ZIP, RAR, ARJ, or GZIP file containing one MIDI file. MIDI files compress very nicely so compressing them can be very useful and can save a lot of disk space. You can compress any of the supported MIDI formats. Use .MIZ file extension for all compressed MIDIs. (Note, however, that most (if not all) other programs will be unable to play any of these compressed MIDIs.)
Q: Why can't the 'reverb' or 'chorus' options be enabled ?
A: Because the currently selected port doesn't support it. At the moment only MS synth supports reverb; no port known to me supports chorus. You will be able to enable those effects on future hardware ports if they support it.
Q: Why does the plug-in refuse to load some HMP files ?
A: There is some sort of 'compressed HMP' format. I've found those files in Whiplash / Fatal Racing. I have no idea how to decode them. I've managed to convert Fatal Racing HMPs to standard MIDI (don't ask how); if you really need them, email me.
Q: How do I create MIDI radio on my web page ?
A: Upload some MIDI files (preferably compressed) to your web site, then create a playlist containing their URLs (not their local file paths on your computer) and upload it too; then put a link to the playlist on your web page.
Q: What is the optimal mixing frequency for MS synth ?
A: Use 22k when you listen to MIDI with no extra stuff (custom DLS, reverb, etc.) enabled. All GM.DLS samples are 22k; 44k will be much slower and sound almost identical. Use 44k when you convert something to WAV for burning to an audio CD.
Q: What does looping do ?
A: Looping enables you to listen continuously to one MIDI file without delays while restarting. Some files (HMI) contain loop start points; looping enables you to make them sound correct.
Q: How do I convert HMP/HMI/XMI/CMF/MUS to MID ?
A: Open file info box (double-click on song title in Winamp window), then click on 'save...' button.
Q: I have 100 megs of MIDIs on my hdd and I want to compress them. Is there a program that will automatically compress all of my MIDIs ?
A: Check http://pp666.cjb.net/misc.htm.
Q1: Where did Shogo / Blood 2 game music support go ?
Q2: Can I play DirectMusic segment files (.sec, .sgt) ?
Q3: Can I play Final Fantasy 8 music with this plug-in ?
A: There is a separate plug-in for this stuff. Check http://pp666.cjb.net/misc.htm ("DirectMusic plug-in v1.5").
Q: How do I minimize CPU usage while playing MIDIs in the background ?
A: If you don't need VIS, disable sampling and output. It will disable all Winamp 2.x - specific sound data processing and cut down CPU usage a lot.
Q: Can I do DSP / EQ with MIDI ?
A: Yes. You can easily configure MS synth to use DSP (enable 'play through Winamp's output system'). Other MIDI devices will require more work (recommended for advanced users only): configure your sound card to record _directly_ from your MIDI synth (not 'what you hear'), mute your MIDI device, then enable sampling and 'send sampled data to DSP / output'.
Q: What does 'hardware setup' do ?
A: It enables you to configure hardware-specific MIDI extensions (XG, GS, etc) using system-exclusive (sysex) commands. This is intended only for MIDI hardware geeks; it does nothing on most common MIDI devices (soundblasters, etc). Refer to your hardware documentation for more info about sysex commands.
Q: What's the difference between streamed and immediate midiOut modes ?
A: They are two different MIDI players, based on midiOut (streamed mode uses midiStream* functions, immediate mode uses midiOutShortMsg/midiOutLongMsg). If your MIDI drivers are 100% OK, both modes will work almost identically. Streamed mode requires less CPU time (about 0.25% of my Athlon 700) and doesn't skip so badly when you use other programs. Immediate mode enables you to use alternate volume setting method which works on every midiOut device.
Q: MS synth skips a lot.
A: Try enabling 'play through Winamp's output system' and 'experimental output mode' in output tab.
Q: I get "Unable to load MIDI file" error.
A: The file that caused it is damaged, even if it does play in other players.
Q: The plug-in crashes Winamp at startup...
A: How did you get here ? :) This bug seems gone but WTH... try removing read_file.dll, especially if you have a P3 CPU. Also try changing hack_no_dm to 1 in winamp.ini (this will totally disable DirectMusic support).
Q: What does the 'source' field in output/sampling do ?
A: Selecting anything else than 'default' causes the plug-in to automatically select that data source when starting sampling.
Q: What's the difference between two output options - "play through Winamp's output system" and "experimental output mode" ?
A: The first option is supposed to work with all sorts of DirectMusic software synths. The other one is more stable (faster, less skipping), but works only with SOME devices (tested with MS synth under DX 6/7/8 and Yamaha SoftSynth DM driver); use it at your own risk.
Q: What does 'reset midiOut volume' button do ?
A: It resets volume for all midiOut devices found in your system. Use it when something sounds too quiet (or doesn't produce sound at all).
Q: What does 'show all DirectMusic devices' option do ?
A: It shows all available DirectMusic output ports on the device list (and causes big mess because most of devices appear twice). Use it only for testing. Normally, the plug-in doesn't show DM devices that are available via midiOut and don't support DLS.
Q: How much space does the fractal animation take ?
A: Very little. Less than this text file.
Q: How do I convert WAV/MP3 do MIDI ?
A: You can't. There are some programs that can do it, but output files don't sound good. If you want to make some MIDIs, get a MIDI sequencer instead.
Q: Some DOOM MUS files sound different than those converted using WinTex (drums start to play a few seconds later). Why ?
A: WinTex's converter sucks - it converts single-track MUS to multi-track MIDI (in order to optimize file size) and messes up track start time while doing this. Just run DOOM and compare...
Q: What do all these strange MIDI file processing options do ?
A: Here's a (quick) explaination of some of them:
* "normalize volume" - scales MIDI channel volume values to fix those 'quiet' files; just a cheap hack, don't expect it to fix all files; it also removes LSB volume commands and some people won't like the way it sounds.
* "remove B9 00 XX / B9 20 XX" - removes instrument bank selection events from drums channel; they occur in some rare files and I have no idea what they are supposed to do (except for messing up drums on my SW60-XG); enabled by default
* "disable sysex commands" - removes hardware-specific commands from loaded files; fixes missing tracks in DirectMusic
* "fix missing DLS drum kits" - removes references to drum kits that can't be found in active DLS files; activate this if you can't hear drums in some songs under DirectMusic
* "fix missing DLS instruments" - automatically remaps istruments that can't be found in active DLS files; ultimate fix for problems with missing instruments under DirectMusic
Q: I experience very bad delays while starting playback. Why ?
A: You are using Microsoft Synthesizer device (or something similar). Use your MIDI hardware instead. If you really have to use this thing, try disabling "always reinitialize port" in DirectMusic tab (it may have some really bad side effects, you have been warned).
Q: ....
A: Go to forums.winamp.com and read Tech Support - Greatest Hits forum.
Known problems:
- Do not use any output plug-ins that can't receive data in real-time (MP3/WMA writers, etc). WAV writer plug-in works fine.
- Do not use any DSP / output plug-ins that change playback time (pitch/tempo control, crossfaders, etc), except for the case when you use WAV writer output plug-in.
- XMIs with embedded compressed DLS (MLS) are not supported and will be played like normal XMIs; decompress them and compress with zip or rar instead.
- sysex events in XMI are NOT supported, because of big mess in XMI format (attempting to read sysex would break a lot of old game files)
- MIDI Mapper / MCI device uses buggy Microsoft's Media Control Interface. It is strongly recommended that you activate it only if nothing else works. It does really bad things if Winamp process priority class is set to high or realtime.
- Old version of ZIP format (v1.x) is not supported.
- XMI looping is not supported yet...
- In midiStream mode loop count is decremented every time when end of song gets buffered; if you use seeking, the song might not loop less times than specified in config.
Micro$oft's bugs found during development (Bill, please read):
- IDirectMusicLoader doesn't get some of RMI files bundled with Win95 (happens with DX6.1; I didn't feel like checking this with DX7 and 8)
- MS synth doesn't reset some controllers correctly between songs (DX678)
- MS synth occasionally forgets channel volume values when I send PMSGs directly to the performance (DX8, older ones probably too); FYI other drivers work perfectly. Check DirectMusic immediate mode.
- MS synth messes with files that contain XG sysex events (DX678) - I've seen some BS in the manual about it, but it isn't a real explaination.
- midiStream multithread safety is totally screwed up (happens in all versions of Win9x/ME)
- MCI hates high process priority class (all win9x)
- There are some MIDI files that use two drum kits simultaneously and constantly switch between them. One of my friends reported that it took several minutes to download one of these files to the performance. Geez.... (DX7, dunno about other versions).
:-p
Changes since v2.0:
- tons of tweaks / fixes
- new midiOut driver
- new about box :-)
Changes since v2.1/v2.11:
- option to disable midiOutReset() commands (fixes evil behaviors on OPL3 hardware)
- new controller / instrument change logic in midiOut mode
- option to send sampled data to output
- new MS synth output code (faster, no more skipping)
- removed buggy midiOut streamed mode and MCI support
Changes since v2.2:
- new device selection / configuration logic
- MCI driver is back
Changes since v2.3:
- new game music file formats: GMD and MIDS
- support for sysex MIDI messages
- new looping options
Changes since v2.31:
- new volume control logic
- improved handling of damaged MIDI files
- option to play in mono
- fixed bugs in MIDS support
Changes since v2.32:
- fixed bugs in panning code
Changes since v2.33 (Winamp v2.71):
- fixed memory leaks in MIDI loader
- fixed $#! bugs in sysex code (FINALLY got Yamaha SW60-XG; hello to all M$-$ynth-haters)
- download support works again
Changes since v2.34:
- misc fixes related to hardware-specific stuff
- added 'normalize volume' option
- configurable XG/GM reset on start / stop
- configurable thread priority
- option to disable sysex commands
- new 'safe' MCI mode
Changes since v2.35:
- sysex commands are _finally_ working correctly
- disabled looping for all DirectMusic devices due to heavy bugs in M$ code
- new midiOut code (streamed mode)
- new config dialog
- MIDI hardware setup
- no more read_file.dll startup crashes
Changes since v2.4 (Winamp v2.72):
- holy war against evil CRT library (smaller and faster dlls, reduced resource usage)
- DirectMusic immediate mode (experimental)
- reduced MS synth hack section (enable GM reset on stop...)
- DirectMusic looping is back (works perfectly in immediate mode)
- automatic mixer config to make midi2wav people happy
- priority doesn't affect midistream to make winmm.dll happy
- MIDI control panel for MO/DM immediate mode (tempo control, channel volumes, etc)
- changed name to "Winamp2 MIDI plug-in" for all versions (will change to Winamp3 soon :) - there is no other MIDI plug-in now; high time to stop pretending that it is a DirectMusic-based player
- 'always reinitialize port' option (on by default, disable to emulate old versions) - slower loading / less bugs
- new volume control logic to make newbies happy and give geeks new toy to mess with; hello to all SB64 owners :-)
- fixed format 2 MIDI files; GMD support now works correctly
Changes since v2.51
- some new fixes in midistream - seems to shut up last crashes related to startup / end sysex messages
- complete workaround for missing drum kits under DirectMusic
- new midiStream seeking logic - if you don't like it, activate 'quick midiStream seeking' in misc tab
- removed crappy MCI safe mode
Changes since v2.52
- more file processing options (some of them were permanently enabled in previous versions)
- ultimate fix for all missing DLS instruments
Changes since v2.53:
- fixed $tupid a$$ M$VC5 me$$up with saving plug-in configuration
- tweaked WA2 output code - waveOut works much better now
- option to do immediate midiOutReset from config window - useful for shutting up Adlib after abnormal termination of some old DOS game
- midiOut volume reset from device tab now affects only currently selected device
- cleaned up file loading - some evil files might load noticeably faster
Changes since v2.54:
- added separate DSP/output options with sampling - now you can shoutcast without messing with output plug-ins
- should shut up people complaining about midi info "locking up" main Winamp window
- option to show fist track text as song title
- better file cache (no more cache size limit) - if you are bad enough, you can force the plug-in to load all of your MIDI files to memory and work without file access at all
Changes since v2.55:
- cache viewer
- better sampling config
- delayed init - lower resource usage when you don't play MIDIs
